home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / boot tools / syspic / syspic.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  11KB  |  246 lines
  1. @database SysPic.guide
  2. @author "Grzegorz Calkowski"
  3. @(C) "The Beet Research"
  4. @$VER: SysPic.guide 2.02 (27.09.95)
  5. @font xen.font 9
  6. @node Main "SysPic v2.02"
  7.              --------------------------------------------------
  8.                              
  9.  SysPic v2.02 
  10.                           "Make your boot look cute!"
  11.                        Cardware 
  12.  1995 The Beet Research
  13.                          written by Grzegorz Calkowski
  14.       -----------------------------------------------------------------
  15.                              Table of contents:
  16.               @{" Disclaimer " link Legal}             Legal information
  17.               @{" Copying " link Copying}                Distribution & Copyright
  18.               @{" Introduction " link Intro}           What the hell is it?
  19.               @{" Requirements " link Require}           Hard & soft required
  20.               @{" Installation " link Install}           Before using AutoAssign
  21.               
  22.               @{" Usage - general notes " link Usage}  Use it!
  23.               @{" Bugs " link Bugs}                   Nothing' is perfect
  24.               @{" To Do " link ToDo}                  What should be done
  25.               @{" History " link History}                Short program history
  26.               @{" Author " link Author}                 Who made it?
  27.               @{" Acknowledgements " link Acknow}       Thank you!                  
  28. @endnode
  29. @node Legal "Disclaimer"
  30. Disclaimer
  31. ----------
  32.     The program executable and information above is provided "as is".  No
  33. representations or warranties are made with respect to the accuracy,
  34. reliability, performance, currentness, or operation of this software and
  35. information, and all use is at your own risk.  The author doesn't assume any
  36. responsibility or liability whatsoever with respect to your use of the program
  37. and information.
  38. @endnode
  39. @node Copying "Copying"
  40. Copying
  41. -------
  42.     SysPic is now CardWare (no longer, hmhm, BeetWare...).  This means your are
  43. *OBLIGED* to send me a postcard if you use it regulary.  (BTW:  if you use
  44. SysPic, it's probably the most frequently used proggie, isn't it?) Treat the
  45. card as a shareware fee.
  46. This program can be freely distributed under following conditions:
  47.         1. Everything in this distribution must be kept together and
  48.            unaltered. Applies to:
  49.            C/SysPic                     (the program itself)
  50.            C/SysPic.020                 (68020+ version)
  51.            C.info
  52.            SysPic.doc                   (plain ASCII doc)
  53.            SysPic.doc.info
  54.            SysPic.guide                 (AmigaGuide
  55. 'd doc)
  56.            SysPic.guide.info
  57.            WBStartup/ClosePic           (command removing the picture)
  58.            WBStartup/ClosePic.info      (its icon - MWB style)
  59.            WBStartup.info
  60.         2. Copyright notices are not removed from executable and
  61.            documentation.
  62.         3. No more than a nominal fee is charged to cover cost of magnetic
  63.            media.
  64. SysPic is Copyright (C) 1995 The Beet Research. All rights reserved.
  65. @endnode
  66. @node Intro "Introduction"
  67. Introduction
  68. ------------
  69.     If you think that black screen during boot time is boring and you want make
  70. the boot look more professional (or even fancy) it is definitely program for
  71. you. I know there are other similar programs - but SysPic's features make it
  72. absolutely the BEST!
  73.     SysPic is a small viewer-like program meant to show a picture during the
  74. boot time.  The picture can be removed at any time using an independent command
  75. (ClosePic) which can be placed for example in your WBStartup drawer.
  76.     Features - SysPic
  77.       o is small & fast
  78.       o shows IFF-ILBM pictures of any size and resolution
  79.       o supports AGA modes (also HAM8)
  80.       o forces Workbench to open behind the displayed picture so it can be
  81.         closed after whole Workbench initialization
  82.       o blanks the pointer sprite so you won't see it when the Workbench
  83.         screen activates (it would look annoying) (see Bugs)
  84.       o has a nice random number generator
  85.       o detaches from shell in an intelligent way (i.e after loading
  86.         the picture)
  87.       o !!!COOL-> sets overscan prefs before IPrefs will do it. <-COOL!!!
  88.       o supports BeetLogin (closes it's 'fake' screen)
  89.       o is 100% legal
  90.       o has been tested with Enforcer, Mungwall & MemWatch
  91. @endnode
  92. @node Require "Requirements"
  93. Requirements
  94. ------------
  95.     SysPic requires at least Kickstart 3.0 (sorry, I promised to make it 2.04
  96. compatible...  but not this time yet).  It makes not much sense to use it
  97. without harddisk.  Memory requirement depends on size and no.  of colours of
  98. displayed picture.
  99.     SysPic uses iffparse.library which should be installed in your LIBS:.
  100. The library comes with your Workbench package.
  101. @endnode
  102. @node Install "Installation"
  103. Installation
  104. ------------
  105.     It's fairly easy.  First copy file 'SysPic' whereever you want.  I
  106. recommend you to put it to C:  or somewhere else on your command path.  Then
  107. add to your 'startup-sequence' following line:
  108.         SysPic <picture> <options>
  109.     As of version 2.00 SysPic sets the overscan prefs so you can put it right
  110. after SetPatch (recommended).
  111.     In order to remove opened picture, the small program 'ClosePic' is needed.
  112. Simply drop it to 'WBStartup' drawer, which is the best suitable place for it.
  113. To have picture closed when whole Workbench is initialized set STARTPRI
  114. tooltype to -128.  It assures that 'ClosePic' will be launched last (for your
  115. convinience it is already set to -128 :).
  116.     If you don't put it to 'WBStartup' drawer you have to add following line at
  117. the end of 'startup-sequence':
  118.         ClosePic
  119.     Note, that there is 68020+ version supplied.  If you have 68020, 68030,
  120. 68040, or maybe 68060 based Amiga you should use it instead.
  121. @endnode
  122. @node Usage "Usage"
  123. Usage
  124. -----
  125.     The main program - 'SysPic' can be used only from Shell.  It makes not much
  126. sense to use it from Workbench (for what ?).  Therefore don't try to launch it
  127. from WB because it will do nothing (at least it won't crash the machine).
  128.     The options template for 'SysPic' looks like:
  129.     PICTURE/A,RANDMIN/N,RANDMAX/N,DIGITS/N,BF=BESTFIT/S,SO=SETOSCN/S
  130.     where
  131.         PICTURE <path>          Specifies the filepath for an IFF-ILBM picture.
  132.                                 Note, that PICTURE keyword can be omitted.
  133.                 If you specify an asterisk (*) in the name it
  134.                 will be replaced with randomly generated
  135.                 number. In such case you have to specify both
  136.                 RANDMIN and RANDMAX.
  137.     RANDMIN <number>    Lower bound for random generator
  138.     RANDMAX <number>    Upper bound for random generator
  139.     DIGITS <size>        Specifies how many digits will be inserted.
  140.                 If length of generated number is shorter than
  141.                 specified size it will be filled with leading
  142.                 zeros.
  143.         BF or BESTFIT           Switch - if specfied program will use
  144.                                 BestModeIDA() function of Kickstart 3.0+
  145.                                 to get the best resolution for the picture.
  146.                                 It sometimes can give unexpected results.
  147.                                 Generally it's better to save the picture in
  148.                 desired viewmode.
  149.     SO or SETOSCN        Sets your overscan preferences (from
  150.                 envarc:sys/overscan.prefs file). It avoids
  151.                 the very annoying screen-jump when IPrefs sets
  152.                 the overscan prefs. It's very usable when you
  153.                 want to display a picture in a multisync mode
  154.                 like DBLPAL or MULTISCAN, which overscan
  155.                 preferences usually differ from the defaults.
  156.                 Note, it's a hack! See Bugs.
  157.     The 'ClosePic' can be used from Workbench as well what is recommended.
  158. Simply put it into 'WBStartup' drawer and forget about it.  See @{"Instalation" link Install}.
  159.     Well, in fact, SysPic is full-featured viewer.  It can display any ILBM
  160. image upto 256 colours and HAM6/HAM8 images as well.  IFF parsing routines are
  161. based on orginal C= routines.
  162. @endnode
  163. @node ToDo "To Do"
  164. To Do
  165. -----
  166.     No ideas. I think the proggie is complete.
  167.     But if you have some suggestions...?
  168. @endnode
  169. @node Bugs "Bugs"
  170.     Sprite blanking is still not perfect.  Why?  Normally it's no problem to
  171. get rid of sprites - it can be done by disabling sprite DMA or just by setting
  172. a window's mouse pointer to an invisible one.  It works fine :-).  But no if an
  173. another program is poking in sprite stuff in the background.  And this is the
  174. case, because IPrefs does so (it changes display params with VideoControl(),
  175. namely).  The only thing I could do was an interrupt server, which was turning
  176. off sprite DMA subsequently.  I have no other ideas!  If you know a better one
  177. _please_ contact me!!
  178.     Another thing, not really a bug - overscan prefs.  Starting from Release 2
  179. there are no documented methods for setting preferences.  The only program in
  180. universe able to do it is IPrefs.  Well, everything can be done :-) SysPic sets
  181. the overscan prefs EXACTLY in the same way as IPrefs does.  But this can be
  182. considered as kind of hack.  Well, works fine under V39 & V40, however, this
  183. maybe not be the case under future releases of Kickstart.
  184. @endnode
  185. @node Author "Author"
  186. Contacting the author
  187. ---------------------
  188.     Any ideas, bug reports, donations, hardware (for example Cyberstorm
  189. turboboard for my A4000), etc.  will be sincerely welcomed.  Just contact me!
  190.     My addy:
  191.                 Grzegorz Calkowski
  192.                 Rzedowice
  193.                 ul.Dobrodzienska 8
  194.                 42-780 Dobrodzien
  195.                 POLAND
  196.     Phone:      +48(0)34-575875
  197.     E-mail:    calkowsk@us.edu.pl
  198. (Sorry, for my poor English...)
  199. Always remember:
  200. ----------------
  201.         Beeting is beliving...
  202.         and Amiga is the best computer ever!
  203. @endnode
  204. @node Acknow "Acknowledgements"
  205. Acknowledgements
  206. ----------------
  207. Thanks go to:
  208.    o  Michal Prochownik for general support & for the game idea
  209.       (We WILL make it!)
  210.    o  Ryszard "Justus" Baginski for ClosePic's icon.
  211.    o  Jacek "Plexa" Miklasiewicz for the job...
  212.    o  Jacek "Shind" Grzegorczyk for the 340MB HDD (really nice gift 8-)
  213.    o  For develop team at C= (R.I.P) for the wonderful machine.
  214.    o  ESCom for Amiga Technologies.
  215. @endnode
  216. @node History "History"
  217. History
  218. -------
  219. v1.00
  220.  (22.07.95)
  221.     o First BETA release.
  222. v1.50 (25.08.95)
  223.     o not "historized" and not released
  224. v2.00 (30.08.95)
  225.     ** not released to public
  226.     o Now SysPic automatically detaches from current Shell process. It does it
  227.       in intelligent way, i.e exits after the picture is loaded & displayed.
  228.     o Added random generator. New options: RANDMIN, RANDMAX, DIGITS.
  229.     o Added feature of setting overscan prefs before IPrefs will do that!
  230.       (New option: SETOSCN). It's a hack! See Bugs.
  231.     o Sprite blanking works better but it is still unreliable.
  232.     o Added shortcut for BESTFIT - BF.
  233. v2.01 (05.09.95)
  234.     ** not released to public
  235.     o Improved sprite blanking. A little, in fact :-). See Bugs.
  236. v2.02 (27.09.95)
  237.     o Added support for my other utility - BeetLogin. Automatically closes
  238.       'fake' screen leftover by it.
  239.     o In some cases SysPic didn't display error messages (ie "Not IFF file").
  240.       Fixed.
  241.     o Rendezvous port priority set to a high value to improve ClosePic's
  242.       performance.
  243.     o Documentation updated.
  244.     o Finally released... (and probably the final release... :-)
  245. @endnode
  246.